Scanning a Keypad with the Neuron® Chip 



LONWORKS™ Engineering Bulletin 

Introduction 

This engineering bulletin describes how the Echelon NEURON CHIP can be used to 
scan a simple 16-key switch matrix to provide a numeric and/or special-function 
keyboard without the use of a keyboard encoder. 

Depending on the number of keys to be scanned and the number of free I/O pins, 
different solutions are possible. 

Scanning up to Eleven Keys 

For up to four keys, the simplest way is to connect normally open switches to any 
of the pins IO_4, IO_5, IO_6, or IO_7 of the NEURON CHIP. These pins have on-chip 
pull-up resistors that should be enabled by the NEURON C program. 
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Sample software to drive these switches is shown below. After a switch is pressed, 
the software waits for some time (10 msec in this example) to allow the switch 
bounces to subside. The appropriate delay depends on the mechanical construction 
of the switch and how long it takes to settle in the closed or open position. 
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♦pragma enable_io_jpullups 
IO_4 input bit io_key_A; 
I0_5 input bit io_key_B; 
I0_6 input bit io_key_C; 
I0_7 input bit io_key_D; 

when ( io_changes ( io_key_A ) to ) { // wait till key is pressed 

delay ( 400 ); // wait 10 milliseconds to debounce 
if ( io_in ( io_key_A ) == ) { // key is really pressed 
// handle key press for key A here 

} 

} 

similarly for keys B, C and D. 



Since each key independently controls a single input pin, this kind of circuit can 
handle the case where multiple keys are pressed at the same time. 

If a keypad has more than four keys (up to 11), the system designer can use the 
other pins (IO_0 through IO_10) of the NEURON CHIP in the same way. Note that 
for pins IO_0 through IO_3 and IO_8 through IO_10, there are no on-chip pull-ups. 
These should be provided with external resistors. 

Scanning up to Thirty Keys 

But using all the pins in this way may be wasteful if there are other I/O functions 
that need to be connected to the NEURON CHIP. A more economical way is to 
connect the keys in a rectangular matrix, using some of the pins to drive the rows 
of the matrix, and some of the pins to sense the columns. This engineering 
bulletin describes scanning a 4 X 4 matrix of keys (16 keys). A maximum of 30 keys 
can be scanned in this way, using all 11 pins to scan the keys in a 6 X 5 matrix. 

The NEURON CHIP has 11 general-purpose I/O pins that can be used in several I/O 
modes. One of these modes is nibble mode, where groups of four I/O pins can be 
read or written together. Below, pins IO_0, IO_l, IO_2 and IO_3 are used as outputs 
to drive the columns of the switch matrix, and pins IO_4, IO_5, IO_6 and IO_7 as 
inputs to sense the rows of the switch matrix. 
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The NEURON CHIP has on-chip pull-up resistors on pins IO_4, IO_5, IO_6 and IO_7, 
which are enabled by the software statement #pragma enable_io_pullups . 
When none of the keys are pressed, pins IO_4 through IO_7 are therefore pulled 
up to logic level 1. In the declaration statements, the software configures these four 
pins as inputs, and pins IO_0, IO_l, IO_2 and IO_3 as outputs. External diodes are 
connected to these output pins to avoid logic clashes in the event that more than 
one key in the same row is pressed at the same time. 

When none of the keys are pressed, the software writes logic O's to the four output 
pins IO_0 through IO_3. When a key is pressed, one of the input pins IO_4 through 
IO_7 is pulled low, and the NEURON CHIP firmware detects the transition and 
generates an io_update_occurs event, thus activating a task to handle the 
event. In this example, this task first waits for 10 ms to ensure that any key bounce 
has subsided. In order to determine which key has been pressed, the software then 
pulls the output pins IO_0 through IO_3 low one at a time, leaving the other three 
output pins high, meanwhile reading the input pins each time it does this. If a low 
input is detected on a pin, this corresponds to the row in which the key is to be 
found. The row and column number are then used as lookup keys into a two- 
dimensional array to determine the key code for the key that was pressed. 

For example, assume that no key is currently pressed. The output pins are 0, 
and the input pins are 1111. When the 9 key is pressed, the pin IO_5 is pulled 
low, causing the input to change to 1 1 1. The software then scans the keyboard by 
outputting the following values to the output pins: 



Column 



1 

2 



Output 

Written 

1110 

1101 

1011 



Input 

Read 

1111 

1111 

1101 



-> Bit 1 is 0, 

so key pressed is column 2, row 1 
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The software updates a network variable nv_keypad_char with an ASCII 
character representing the key that has been pressed. In this example, the 
characters used are - 9, * and #, corresponding to the layout of a 12-key telephone 
keypad. The other four keys are coded as A, B, C, and D. When the key is released, 
the network variable is updated with the ASCII NUL character, which represents 
the absence of a key press. (The NUL character is different from the '0' character, 
which is a valid character for this keyboard.) The output network variable is of a 
standard type - SNVT_char_ascii - which allows this node to interoperate with 
other nodes that accept this type of data from the network. 

Code Example for Sixteen Keys 

//================== — ================================================== 

// 

// File: keypad. nc 

// Created: 5/1/91 

// Purpose: Scan 16-key keypad 

// 

//====== = ========================= ; ===== 

// 

// Network Variable Objects 

// 

network output SNVT_char_ascii nv_keypad_char; 

// 

// I/O Objects 

// 

♦pragma enable_io_pullups 

IO_0 output nibble io_keypad_columns =0; // pull down all lines 

IO_4 input nibble io_keypad_rows; 

// 

// Global Variables 

// 

const char digit_table[ 4 ][ 4 ] = { "*0#D", "789C", "456B", "123A" }; 

// map key codes to ASCII 
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// 

// 10 task 

// 

when ( io_changes ( io_keypad_rows ) ) { 
int row, col, row_val; 

delay ( 400 ) ; // 10 msec debounce 

for( col = 0; col < 4; col++ ) { 

io_out ( io_keypad_columns, ~ ( 1 « col ) ) ; 

// pull down one line 
row_val = ~io_in( io_keypad_rows ); // read rows 
f or ( row = 0; row < 4; row++ ) { // find which one is zero 

if( row_val & ( 1 « row ) ) { 

nv_keypad_char = digit_table [ row ] [ col ]; 

// propagate keypad character to network 

goto done; 

} 

} 

} 

nv_keypad_char = '\0'; // propagate NUL character 

done : 

io_out ( io_keypad_columns, ); // pull down all lines again 

) 
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